<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>User guide for Bodgitt & Scarpers</title>
</head>
<body>
<h1>User Guide for Bodgitt & Scarper Application</h1>
This User Guide provides information on how to start and use the Bodgitt & Scarpers Application. The guide is divided
in two areas. First how the Database Application is started and the how the GUI client is started and used.
<h2>Database Server(Server Application)</h2>
<h3>How to Start the Database Server</h3>
The Database Server application is started with the following command:
<blockquote><tt>java -jar runme.jar server</tt></blockquote>
When the Server application starts a pop-up dialog is presented. Here the user must enter the location of the Database that the 
Server has to use. The database location is stored in the <tt>suncertify.properties</tt> file.<br><br>  
<center><img alt="Locate Database Popup" src="userguideimages/locatedatabase.jpg" 
name="Locate Database Pop-up dialog"></center>
<h2>GUI Client</h2>
<h3>How to start the GUI Client(Client or Alone mode)</h3>
The GUI can be started either in a Client mode(networked mode) or Alone mode(non-networked mode)
<br>
GUI Client mode is stated with the following command:
<blockquote><tt>java -jar runme.jar</tt></blockquote>
GUI Alone mode is started with the following command:
<blockquote><tt>java -jar runme.jar alone</tt></blockquote> 
When the GUI Client is started in a networked mode, a pop-up dialog is shown. Here the user must specify the Database Server 
host.<br>
<b>Note that in networked mode, the Database Server Application must be running.</b>
<br><br>
<center><img alt="GUI" src="userguideimages/serveraddress.jpg"></center>
<br>
<h3>GUI Main view</h3>
The main view consists of three areas:
<ul>
<li>Record(s) panel<br>This panel consists of a table showing Records that matches search criteria entered by the user. <br>
Records that are shown in the table can be selected for booking.</li>
<li>Book Record panel<br>Here the user can lock and book a selected record. A Record must be locked before it can be updated. <br>
Locking a Record is performed by clicking the Lock button(selecting the button).
<br>Update of a locked Record is done by entering a text in the Owner textfield followed by a apply button click.
<br>Unlocking a Record is done by clicking the Lock button(unselecting the button).
</li>
<li>Record Search panel<br>
Location and Name search criteria can be entered here.<br>
The All Records button gets all Records from the database regarding whatever search criteria is entered by the user.</li>
</ul>
A Status bottom panel shows relevant information when the user interacts with the GUI.
<br><br>
<center><img alt="GUI" src="userguideimages/maingui.jpg"></center>
</body>
</html>